Move documentation to inline comments: GtkCellRendererCombo

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 227c4864a48cbcefe44a30fb7e2dc970843607c5..7bfa2cc3732aa463af31e4d11649ef17c386def5 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -12,6 +12,7 @@ gtkcelleditable.sgml
 gtkcelllayout.sgml
 gtkcellrenderer.sgml
 gtkcellrendereraccel.sgml
+gtkcellrenderercombo.sgml
 gtkcellrendererprogress.sgml
 gtkcellrendererspin.sgml
 gtkcellrenderertext.sgml

diff --git a/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml b/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml
deleted file mode 100644 (file)
index 1a989c9..0000000
--- a/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml
+++ /dev/null
@@ -1,78 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkCellRendererCombo
-
-<!-- ##### SECTION Short_Description ##### -->
-Renders a combobox in a cell
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-#GtkCellRendererCombo renders text in a cell like #GtkCellRendererText from 
-which it is derived. But while #GtkCellRendererText offers a simple entry to 
-edit the text, #GtkCellRendererCombo offers a #GtkComboBox or #GtkComboBoxEntry
-widget to edit the text. The values to display in the combo box are taken from 
-the tree model specified in the 
-<link linkend="GtkCellRendererCombo--model">model</link> property.
-</para>
-
-<para>
-The combo cell renderer takes care of adding a text cell renderer to the combo 
-box and sets it to display the column specified by its 
-<link linkend="GtkCellRendererCombo--text-column">text-column</link> 
-property. Further properties of the comnbo box can be set in a handler for the 
-editing-started signal.
-</para>
-
-<para>
-The #GtkCellRendererCombo cell renderer was added in GTK+ 2.6.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkCellRendererCombo ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GtkCellRendererCombo::changed ##### -->
-<para>
-
-</para>
-
-@cellrenderercombo: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### ARG GtkCellRendererCombo:has-entry ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRendererCombo:model ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRendererCombo:text-column ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_cell_renderer_combo_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-

diff --git a/gtk/gtkcellrenderercombo.c b/gtk/gtkcellrenderercombo.c
index ad154c4aacdd89ce5130d3aaa784594ad2563d77..d14908a53552491419c9193ee6ee3f44494ff3ad 100644 (file)
--- a/gtk/gtkcellrenderercombo.c
+++ b/gtk/gtkcellrenderercombo.c
@@ -30,6 +30,27 @@
 #include "gtkmarshalers.h"
 #include "gtkprivate.h"
 
+
+/**
+ * SECTION:gtkcellrenderercombo
+ * @Short_description: Renders a combobox in a cell
+ * @Title: GtkCellRendererCombo
+ *
+ * #GtkCellRendererCombo renders text in a cell like #GtkCellRendererText from
+ * which it is derived. But while #GtkCellRendererText offers a simple entry to
+ * edit the text, #GtkCellRendererCombo offers a #GtkComboBox or #GtkComboBoxEntry
+ * widget to edit the text. The values to display in the combo box are taken from
+ * the tree model specified in the #GtkCellRendererCombo:model property.
+ *
+ * The combo cell renderer takes care of adding a text cell renderer to the combo
+ * box and sets it to display the column specified by its
+ * #GtkCellRendererCombo:text-column property. Further properties of the comnbo box
+ * can be set in a handler for the #GtkCellRenderer::editing-started signal.
+ *
+ * The #GtkCellRendererCombo cell renderer was added in GTK+ 2.6.
+ */
+
+
 struct _GtkCellRendererComboPrivate
 {
   GtkTreeModel *model;